DATA FILE FORMAT

This documents the data file format for data saved using option F7 from
the main menu. In addition to the data the setup information is also
saved. The data can be read and used to produce hardcopy plots or
printouts. 

The format is as follows:

Offset	Size	Type	Function
0	4	float	The frequency of the oscillator on the board
4	2	int	The selected clock - see text
6	2	int	Trigger word
8	2	int	Don't care word
10	2	int	Trigger length 0 or 1
12	2	int	Index of first valid data point in data array
14	2	int	Index of last valid data point in data array
16	496	char	Reserved
512	16384	int	Data array as acquired

The following is example C code that can be used to read data files
produced by RGBLOGIC.

/* C code to read in the data file */
.
float masterclock;		/* oscillator frequency */
int clockrate;			/* selected clock - see text */
unsigned int trigger;		/* trigger word */
unsigned int dontcare;		/* don't care word */
int triglength;			/* trigger valid 0 or 1 - see text */
int first;			/* index of first valid data in dbuf */
int last;			/* index of last valid data in dbuf */
char dummy[496];		/* space filler for reserved area */
unsigned int dbuf[8192];	/* acquired data buffer */
.
.
/* read file into proper variables here */
fp=fopen(file,"rb");
fread(&masterclock,sizeof(masterclock),1,fp);
fread(&clockrate,sizeof(clockrate),1,fp);
fread(&trigger,sizeof(trigger),1,fp);
fread(&dontcare,sizeof(dontcare),1,fp);
fread(&triglength,sizeof(triglength),1,fp);
fread(&first,sizeof(first),1,fp);
fread(&last,sizeof(last),1,fp);
fread(dummy,sizeof(dummy[0]),496,fp);
fread(dbuf,sizeof(dbuf[0]),8192,fp);
fclose(fp);